home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat4 / dmedia / next.z / next
Encoding:
Text File  |  2002-10-03  |  5.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. nnnneeeexxxxtttt((((4444))))                                                                nnnneeeexxxxtttt((((4444))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      next, au, sun - NeXT / Sun .au Audio File Formats
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////aaaauuuuddddiiiiooooffffiiiilllleeee....hhhh>>>>
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      The Audio File Library currently supports 13 of the commonly found audio
  16.      file formats, i.e., is able to recognize, read, and write sample data and
  17.      header information to and from files in these formats.  It is important
  18.      not to confuse _s_a_m_p_l_e or _a_u_d_i_o _d_a_t_a _f_o_r_m_a_t_s with _f_i_l_e _f_o_r_m_a_t_s.  The
  19.      former refers to the bit-wise organization of the sound samples in the
  20.      file, i.e., whether the format is 8-bit integer or 16-bit unsigned, etc.
  21.      Audio file format refers to the structure of the _a_u_d_i_o _f_i_l_e _h_e_a_d_e_r, the
  22.      chunk of on-disk data which preceeds the samples and which provides
  23.      information about the file to the audio program.  A single audio file
  24.      format may support a large variety of sample formats.
  25.  
  26.      The NNNNeeeeXXXXTTTT FFFFiiiilllleeee FFFFoooorrrrmmmmaaaatttt ((((nnnneeeexxxxtttt)))) was created by NeXT, Inc.  It consists of a
  27.      fixed-length header of 24 bytes followed by a variable-length text or
  28.      data block (minimum length 4 bytes), followed by a contiguous block of
  29.      binary data representing the sound samples.  Sun Microsystems, Inc., used
  30.      this format as the model for their .au file format (but see CCCCAAAAVVVVEEEEAAAATTTTSSSS
  31.      below).
  32.  
  33. DDDDAAAATTTTAAAA FFFFOOOORRRRMMMMAAAATTTT SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNNSSSS
  34.      SSSSaaaammmmpppplllleeee FFFFoooorrrrmmmmaaaattttssss::::
  35.           Two's complement integer, 32-bit single-precision floating point, or
  36.           64-bit double-precision floating point
  37.  
  38.      SSSSaaaammmmpppplllleeee WWWWiiiiddddtttthhhhssss::::
  39.           For integer:  8, 16, 24, and 32 bit;  floating points are always 32
  40.           and 64 bit, respectively
  41.  
  42.      BBBByyyytttteeee OOOOrrrrddddeeeerrrrssss::::
  43.           Only bigendian supported;  littleendian files are generated on Intel
  44.           NeXT machines
  45.  
  46.      CCCChhhhaaaannnnnnnneeeellll CCCCoooouuuunnnnttttssss::::
  47.           Any nonzero number, but 1, 2, and 4 are only ones found.
  48.  
  49.      CCCCoooommmmpppprrrreeeessssssssiiiioooonnnn FFFFoooorrrrmmmmaaaattttssss::::
  50.           CCITT G.711 A-Law
  51.  
  52.           CCITT G.711 ulaw
  53.  
  54.           CCITT G.722 (SND_FORMAT_ADPCM_G722)
  55.  
  56. FFFFIIIILLLLEEEE FFFFOOOORRRRMMMMAAAATTTT SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNNSSSS
  57.      NeXT files can contain additional chunks of data.  Most of these are
  58.      parsed by the AF and made available:
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. nnnneeeexxxxtttt((((4444))))                                                                nnnneeeexxxxtttt((((4444))))
  71.  
  72.  
  73.  
  74.      IIIInnnnssssttttrrrruuuummmmeeeennnntttt CCCCoooonnnnffffiiiigggguuuurrrraaaattttiiiioooonnnnssss::::
  75.           None allowed
  76.  
  77.      MMMMaaaarrrrkkkkeeeerrrrssss::::
  78.           None allowed
  79.  
  80.      MMMMiiiisssscccceeeellllllllaaaannnneeeeoooouuuussss CCCChhhhuuuunnnnkkkkssss::::
  81.               AAAAFFFF____MMMMIIIISSSSCCCC____NNNNeeeeXXXXTTTT    NeXT 'info' chunk
  82.  
  83. CCCCAAAAVVVVEEEEAAAATTTTSSSS
  84.      The AAAAFFFF____MMMMIIIISSSSCCCC____NNNNeeeeXXXXTTTT miscellaneous chunk is typically used to store a
  85.      variable (and infinitely extendible) text string containing comments,
  86.      copyright information, etc.  There are, however, a significant number of
  87.      NeXT format soundfiles which use this space to store application-specific
  88.      binary (i.e., non-ascii) data.  There is no guarenteed way to determine
  89.      which is true, so applications should excercise care in printing the
  90.      contents of this chunk.
  91.  
  92.      Most audio file format documents claim that NeXT and Sun .au files have
  93.      identical header formats.  This is not the case.  The difference lies in
  94.      the text block which follows the header:  NeXT files require that this
  95.      chunk be at least 4 bytes (chars) long, whereas this chunk may be zero-
  96.      length in a Sun .au file.
  97.  
  98.      The Audio File Library will always save 8kHz sampling rate values as the
  99.      "SND_RATE_CODEC" value (8012.8210513).  The data in the file will not be
  100.      rate-converted; the mapping only occurs in the header writing procedure.
  101.  
  102. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  103.      afInitFileFormat(3dm), afGetFileFormat(3dm), afIntro(3dm),
  104.      afInitCompression(3dm), afGetCompression(3dm)
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.